filename of stack
Type
property
Summary
Reports the file path of the file a stack is stored in.
Syntax
set the filename of <stack> to <filePath>
Description
Use the filename of stack property to specify where a stack file is stored on the user's system.
If the stack is a main stack, its filename of stack property reports the file path of the file the stack is stored in. If the stack is the main stack of a standalone application, the filename of stack property reports the name and location of the application.
If the stack is a substack, its filename of stack property is empty. To find out what file a substack is stored in, use the form the effective filename of stack. You cannot set the filename of stack property of a substack and attempting to will result in an execution error being thrown.
If the stack has not yet been saved, its filename of stack property is empty.
On OS X systems, standalone applications are stored as application bundles. A bundle behaves like a file but is actually a folder, and the main stack of a standalone application is inside this folder. The filename of stack property reports the location of the application inside the bundle, not the bundle's location. For example, if the bundle's file path is "/Volumes/Disk/MyApp.app/", the filename of the application's main stack might be "/Volumes/Disk/MyApp.app/Contents/MacOS/MyApp".
Examples
local nameToSave
put the filename of this stack into nameToSave
local savedName
if the effective filename of this stack is savedName then beep
set the filename of this stack to "Test.livecode"
set the filename of this stack to "/Volumes/Lizards/Godzilla.livecode"
# set the defaultFolder to the folder containing the stackfile
set the itemDelimiter to slash
get the effective filename of this stack
set the defaultFolder to item 1 to -2 of it
Related
function: stacks
glossary: application bundle, execution error, file, file path, folder, main stack, OS X, property, stack file, standalone application, substack
message: saveStackRequest
object: stack
property: defaultFolder, itemDelimiter, stackFiles
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile